home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / language / bcf.lzh / LIES.TXT < prev    next >
Text File  |  1990-03-19  |  15KB  |  437 lines
  1.     ------------------------------------------------
  2.     |             BC-FORTRAN77 Vers.1.3C           |
  3.     |  Copyright: Andre Koestli                    |
  4.     |     1990    Martin-Luther-Str.63             |
  5.     |             D7000 Stuttgart 50               |
  6.     |----------------------------------------------|
  7.     | Die Version "C" von BC-FORTRAN77, bestehend  |
  8.     | aus den nachfolgend beschriebenen 5 Dateien, |
  9.     | ist vollstaendig von mir programmiert. Ich   |
  10.     | gestatte freies Nutzungsrecht an Vers.C fuer |
  11.     | nichtkommerzielle Anwendungen, alle Rechte   |
  12.     | bleiben jedoch bei mir, insbesondere ist der |
  13.     | Verkauf der Vers.C, auch im Zusammenhang mit |
  14.     | anderen Produkten, nicht erlaubt. Jeder Ko-  |
  15.     | pie ist dieser Text unveraendert beizufuegen.|
  16.     | Fuer kommerzielle Anwendungen ist die Vers.P |
  17.     | vorgesehen, die lizenzpflichtig ist.         |
  18.     | Die Anwendung fuer militaerische Zwecke oder |
  19.     | entsprechende Forschung ist verboten!        |
  20.     | Maerz 1990                        A.Koestli  |
  21.     ------------------------------------------------
  22.  
  23.  
  24. BC-FORTRAN77 Version C ist Teil eines umfangreichen
  25. Entwicklungssystems, der Vers.P (siehe unten). Vers.C
  26. soll in einfacher Weise den fuer Programmierkurse noetigen
  27. Compiler zur Verfuegung stellen. Dem kommt entgegen, dass
  28. diese Software fast identisch auf AMIGA, ATARI ST und
  29. MS-DOS Rechnern laeuft.
  30.  
  31.  
  32. BC-FORTRAN77 Vers.P
  33. -------------------
  34.  
  35. BC-FORTRAN77 Vers.P ist ein umfangreiches Entwicklungs-
  36. system, das ausser Compiler und Linker auch noch Editor,
  37. Precompiler und Versionsverwaltung unter einer Benutzer-
  38. oberflaeche vereinigt. Dabei wird dafuer gesorgt, dass im
  39. Entwicklungszyklus automatisch nur die jeweils veraen-
  40. derten Unterprogramme neu uebersetzt werden; selbst bei
  41. Programmen mit mehreren hundert Unterprogrammen ergibt
  42. sich so ein Entwicklungsschritt (Editieren, uebersetzen,
  43. linken und starten) von wenigen Sekunden. Mathematische
  44. Koprozessoren werden in Vers.P unterstuetzt, ebenso wie
  45. spezielle Befehle des 68020 Prozessors.
  46.  
  47. Vers.P enthaelt einen komfortablen Debugger auf Quelltext
  48. Basis zum interaktiven Austesten sowie einige Biblio-
  49. theken z.B. zur einfachen Plotausgabe auf dem Bildschirm.
  50.  
  51. Inklusive 150 Seiten Handbuch kostet BC-FORTRAN77 Vers.P
  52. DM 350.- und kann bei der oben angegebenen Adresse
  53. bestellt werden. (Bitte AMIGA oder ATARI ST angeben. Fuer
  54. MS-DOS existiert Vers.P derzeit nicht.)
  55.  
  56.  
  57.  
  58. BC-FORTRAN77 Vers.C
  59. -------------------
  60.  
  61. BC-FORTRAN77 Vers.C, auf die sich der Rest dieses Textes
  62. bezieht, besteht aus folgenden Dateien:
  63.  
  64.     LIES.TXT    Dieser Text
  65.     BCF.TTP     Compiler
  66.     BCL.TTP     Linker
  67.     BCRTSY.B    Laufzeitsystem
  68.     MATHLIB.B   Bibliothek mit Standardfunktionen
  69.  
  70. Wird eine Kopie angefertigt, muessen immer alle Dateien
  71. unveraendert uebernommen werden.
  72.  
  73. Am besten arbeitet man mit einer Command-Shell. Falls
  74. keine Shell vorhanden ist koennen die Programme aber auch
  75. vom Desktop gestartet werden, die Optionen und
  76. Dateinamen muessen dann in ein Window eingegeben werden,
  77. das nach dem anklicken des Programms erscheint.
  78.  
  79.  
  80.  
  81. Installation.
  82. -------------
  83.  
  84. Die einfachste Arbeitsweise ergibt sich, wenn nur in
  85. einem Directory gearbeitet wird, in dem dann alle
  86. Dateien von BC-FORTRAN77 stehen.
  87.  
  88. Sollen mehrere Directories verwendet werden, so kopiert
  89. man BCF.TTP und BCL.TTP in ein Directory, in dem die
  90. Shell nach Programmen sucht. BCRTSY.B und MATHLIB.B
  91. sollten in das Directory \BC des aktuellen Laufwerks
  92. kopiert werden, damit sie vom Linker gefunden werden.
  93.  
  94.  
  95.  
  96. Compiler
  97. --------
  98.  
  99. Der Compiler wird gestartet mit
  100.  
  101.     BCF [-Option...] Datei...
  102.  
  103. oder vom Desktop durch anklicken von BCF.TTP und
  104. anschliessender Eingabe von Optionen und Dateinamen.
  105.  
  106. Enthaelt Datei keinen Punkt, so wird .F angehaengt.
  107. Die uebersetzte Form der Programme wird in Datei.B
  108. abgelegt.
  109.  
  110. Beispiel:
  111.  
  112.     BCF -D TEST.F
  113.  
  114. Uebersetzt TEST.F mit Debug-Option nach TEST.B
  115.  
  116.     BCF TEST SUB
  117.  
  118. Uebersetzt TEST.F nach TEST.B und SUB.F nach SUB.B
  119.  
  120.     BCF TEST.X
  121.  
  122. uebersetzt TEST.X nach TEST.B
  123.  
  124.  
  125. Compiler Optionen
  126. -----------------
  127.  
  128.     -D      Debug, fasst -BVL zusammen.
  129.  
  130.     -B      deBugcode, impliziert -H und erzeugt
  131.                 ausserdem Code fuer Debuggeraufrufe,
  132.                 zum Ueberpruefen von Feldgrenzen und
  133.                 Substrings.
  134.  
  135.     -H      parcHeck, Code zum Ueberpruefen der Parameter-
  136.                 listen und auf Stackueberlauf erzeugen.
  137.  
  138.     -V      Varlist: Variablenliste fuer Debugger.
  139.  
  140.     -L      Lineslist: Zeilennummernliste fuer Debugger.
  141.  
  142.     -U      Uppercase: Klein- in Grossbuchstaben wandeln
  143.                 (ausser in Characterkonstanten und
  144.                 Formaten). Fehlt diese Option, so sind
  145.                 xy, XY, Xy und xY vier verschiedene
  146.                 Variablen!
  147.  
  148.     -F      Freeinput: Quellprogramm nicht im FORTRAN
  149.                 Format. Nichtstandart!
  150.  
  151.     -P      Protokoll: Ausgabe der uebersetzten Zeilen.
  152.  
  153.     -W      Am Ende auf Return warten, sinnvoll, wenn
  154.                 vom Desktop gestartet wird.
  155.  
  156.  
  157. Sprachumfang
  158. ------------
  159.  
  160. BC-FORTRAN77 uebersetzt den vollstaendigen Standard nach
  161. ANSI/ISO. Der Sprachstandard wird allerdings durch
  162. einige Besonderheiten verletzt (meistens werden diese
  163. als Erweiterungen bezeichnet). Ich empfehle dringend,
  164. diese Dialektkonstrukte nicht zu verwenden, da sie nicht
  165. standardisiert und damit nicht genau definiert sind.
  166.  
  167. Die wichtigsten dieser Besonderheiten:
  168.  
  169.     INTEGER*1       8 bit INTEGER
  170.     INTEGER*2      16 bit INTEGER
  171.     INTEGER*4      wie INTEGER
  172.     LOGICAL*1       8 bit LOGICAL
  173.     LOGICAL*2      16 bit LOGICAL
  174.     LOGICAL*4      wie LOGICAL
  175.     IMPLICIT NONE  abschalten der impliziten Typdef.
  176.     COMMON /%adr/  Absoluter Common, adr ist Konstante
  177.                         oder einfache Variable.
  178.     EQUIVALENCE()  zwischen Character und anderen Typen
  179.                    sowie Mischen im Common.
  180.     Rekursive Unterprogrammaufrufe.
  181.     Namen mit max. 8 Zeichen (Standart: 6).
  182.  
  183.  
  184. Als wichtigste Beschraenkungen gibt es:
  185.  
  186.     32kB Code pro Unterprogramm
  187.     32kB SAVE/DATA pro Unterprogramm oder Blockdata
  188.     700  Unterprogramme pro Datei
  189.     500  Verschiedene Commons pro Datei.
  190.  
  191. Daneben gibt es eine Reihe von Beschraenkungen, die bei
  192. unvernuenftig grossen Unterprogrammen zu Fehlermeldungen
  193. fuehren, meistens waere dann aber ohnehin die 32kB Code
  194. Grenze ueberschritten.
  195.  
  196.  
  197. Linker
  198. ------
  199.  
  200. Der Linker wird gestartet mit:
  201.  
  202.     BCL [-Optionen...] Datei...
  203.  
  204. oder vom Desktop durch anklicken von BCL.TTP und
  205. anschliessender Eingabe von Optionen und Dateinamen.
  206.  
  207.  
  208. Enthaelt Datei keinen Punkt, so wird .B angehaengt.
  209. Die Programmdatei wird mit dem Namen der ersten Datei,
  210. aber mit .PRG statt .B, gespeichert. Werden mathe-
  211. matische Standardfunktionen verwendet, so muss auch die
  212. Datei MATHLIB.B aufgefuehrt werden. Das Laufzeitsystem
  213. BCRTSY.B wird automatisch geladen.
  214.  
  215. Beispiel:
  216.  
  217.     BCL -S16 TEST SUB MATHLIB
  218.  
  219. oder
  220.  
  221.     BCL -S16 TEST.B SUB.B MATHLIB.B
  222.  
  223. Linkt die Dateien TEST.B und SUB.B und speichert unter
  224. TEST.PRG das lauffaehige Programm, das eine Stackgroesse
  225. von 16kB verwendet.
  226.  
  227.  
  228. Linker Optionen
  229. ---------------
  230.  
  231.     -Sn     Stackgroesse fuer das zu erzeugende Programm
  232.                 wird auf n kB gesetzt. Fehlt diese
  233.                 Option, so wird ein sehr grosser Stack
  234.                 angenommen. Auf dem Stack werden alle
  235.                 lokalen Variablen/Felder einer Unter-
  236.                 programmverschachtelung abgelegt.
  237.  
  238.     -O      Optimiertes Linken: nirgends aufgerufene
  239.                 Unterprogramme werden weggelassen.
  240.  
  241.     -P      Protokoll: Liste der Commonbloecke und
  242.                 Programmmodule.
  243.  
  244.     -W      Am Ende auf Return warten, sinnvoll, wenn
  245.                 vom Desktop gestartet wird.
  246.  
  247.  
  248. Beschraenkungen
  249. ---------------
  250.  
  251. Die wichtigste Beschraenkung liegt in der RAM Groesse: die
  252. zu erzeugende Programmdatei (ohne Commons und Stack)
  253. kann maximal so gross sein, wie der groesste freie
  254. Speicherblock nach Laden von BCL. Andererseits kann, b